home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / earcd / devel / vbcc-wos / machines / amiga / doc / extralibwos.doc < prev    next >
Text File  |  1999-01-01  |  3KB  |  76 lines
  1.  
  2. INTRODUCTION
  3.  
  4.     extra.lib is a link library for vbcc which contains certain often
  5.     used functions that are not standard ANSI-functions. It may e.g.
  6.     be helpful in porting programs.
  7.  
  8.  
  9. LEGAL
  10.  
  11.     The functions in extra.lib are written by Kasper B. Graversen and
  12.     Volker Barthelmann.
  13.     extra.lib is public domain.
  14.  
  15.  
  16. USAGE
  17.  
  18.     To link with extra.lib you can either use vconfig (add 'extra' or
  19.     'extras' in the lib link menu) or vpm or specify '-lextra' to vc.
  20.     There is also a header file <extra.h>.
  21.  
  22.  
  23. FUNCTIONS
  24.  
  25.     At the moment extra.lib contains the following functions:
  26.  
  27.     getch()         Similar to getchar() but sets the console to raw mode
  28.                     and does not wait for return.
  29.                     Caution: This will be rather slow under WarpOS!
  30.  
  31.     stricmp()       Case-insensitive variant of strcmp(). Can be inlined
  32.                     by #defining __INLINE_STRICMP when including <extra.h>.
  33.  
  34.     strnicmp()      Case-insensitive variant of strncmp(). Can be inlined
  35.                     by #defining __INLINE_STRNICMP when including <extra.h>.
  36.  
  37.     chdir()         Changes the current directory.
  38.  
  39.     clock()         This is an alternative version of the clock() function
  40.                     in vc.lib. clock() is supposed to return the amount of
  41.                     cpu-time spent by the current program. As this is
  42.                     generally not possible on the Amiga clock() from
  43.                     vc.lib always returns -1.
  44.                     However there seem to be several badly written
  45.                     programs that do not check this. So this version
  46.                     of clock() returns values which are strictly ascending
  47.                     for successive calls to clock() and the difference
  48.                     between them is the time difference between the calls.
  49.                     clock() uses the PowerPC-native GetSysTimePPC() call.
  50.  
  51.     iswhitespace()  Variant of isspace(). Can be inlined by #defining
  52.                     __INLINE_ISWHITESPACE when including <extra.h>.
  53.  
  54.     isseparator()   Tests for ',' or '|'. Can be inlined by #defining
  55.                     __INLINE_ISSEPARATOR when including <extra.h>.
  56.  
  57.  
  58. FUTURE
  59.  
  60.     If you are missing certain functions and would like them to be
  61.     included in extra.lib send a mail to Kasper B. Graversen at
  62.  
  63.         (internet)
  64.         kbg2001@internet.dk
  65.  
  66.         (fidonet)
  67.         2:237/30.7
  68.  
  69.     Please explain the desired functions as detailed as possible (how
  70.     they should work, prototypes, return values in case of errors etc.).
  71.     If possible submit source code for the function.
  72.  
  73.  
  74. Kasper B. Graversen and Volker Barthelmann
  75.  
  76.